home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / dmedia / sfplay.z / sfplay
Encoding:
Text File  |  1998-10-30  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ssssffffppppllllaaaayyyy((((1111))))                                                            ssssffffppppllllaaaayyyy((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sfplay - play soundfile
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      sfplay [ options ... ] soundfiles ...
  14.  
  15.      where options are:
  16.         -printinfo
  17.         -reporterror
  18.         -inputraw [ input keywords ... ] end
  19.         -nice
  20.         -device <device>
  21.         -transpose <rate>
  22.         -match
  23.  
  24.  
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      sfplay plays the given soundfile(s).  It will play files in many formats
  28.      not supported by the audio hardware, by automatically converting the data
  29.      as it is played.
  30.  
  31.      If invoked with no arguments, sfplay will display help.
  32.  
  33.      By default, sfplay ignores any file specified that is not a valid
  34.      soundfile, reporting no error.  The -reporterror (-r) option tells sfplay
  35.      to report an error in this case.
  36.  
  37.      It is often useful to see information about soundfiles as they are
  38.      played.  The -printinfo option prints this information in "sfinfo -s"-
  39.      format.
  40.  
  41.      By default, sfplay will set the hardware sampling rate to the rate of the
  42.      file(s) being played.  If the -nice option is specified and the audio
  43.      hardware is being used (that is, another application has an output port
  44.      open, or monitoring is enabled) at the time a given file is played,
  45.      sfplay will not change the hardware sampling rate.  This may result in
  46.      the file sounding incorrect, but the application using the audio device
  47.      previously will not be disturbed.  This can be remedied using the -match
  48.      argument, which  tells sfplay to rate-convert the sound to match the
  49.      current output port setting.  This implies -nice as well.
  50.  
  51.      This program will play audio files in any recognized audio format (i.e.,
  52.      any sample width, byte order, sample type, channel count) including all
  53.      supported compression types.  It will play sounds with any number of
  54.      channels (mixing them down as is appropriate), will play at any of the
  55.      standard sampling rates appearing on the Audio Control Panel, and will
  56.      convert any other rates to match.  As a special case it will play codec-
  57.      rate (8012.8210513 Hz) files at 8000.00 Hz, and issue a warning to this
  58.      effect.  The -transpose option tells sfplay to play a soundfile at an
  59.      alternate sampling rate, as set by <rate>.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssffffppppllllaaaayyyy((((1111))))                                                            ssssffffppppllllaaaayyyy((((1111))))
  71.  
  72.  
  73.  
  74. RRRRAAAAWWWW DDDDAAAATTTTAAAA
  75.      sfplay can also play soundfiles which contain raw (headerless) data.  In
  76.      this case the data format must be specified, using the appropriate
  77.      keywords with the -inputraw (-i) option.
  78.  
  79.      For example, many Macintosh and PC soundfiles are actually raw data files
  80.      containing 8-bit unsigned mono or interleaved stereo samples.  For these
  81.      files, the sampling rate is generally 8 kHz or 22.05 kHz.  So this
  82.      statement,
  83.  
  84.         sfplay -i integer 8 unsigned chan 2 rate 8000 end raw.mac
  85.                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  86.  
  87.      will play such a raw data file at 8 kHz.
  88.  
  89.      The keywords are underlined.  Don't forget the 'end' !  It tells sfplay
  90.      when the keywords end and the other options and filenames begin.
  91.  
  92.      See sfkeywords(1) for a complete description of the keywords used to
  93.      describe soundfile formats.
  94.  
  95.      It is also possible, and perhaps preferable, to first convert the raw
  96.      data to a soundfile such as an aiff file with sfconvert(1), and then
  97.      simply say "sfplay file.aif" .
  98.  
  99.  
  100. HHHHAAAARRRRDDDDWWWWAAAARRRREEEE
  101.      sfplay works only on systems  with  Iris Audio Processor.
  102.  
  103.  
  104. BBBBUUUUGGGGSSSS
  105.      sfplay will not play 4-channel files.  It currently assumes the hardware
  106.      can only play mono and stereo files.  This will be amended in a future
  107.      release.  You can use playaifc to play 4-channel AIFF/AIFF-C files.
  108.  
  109.  
  110. AAAAUUUUTTTTHHHHOOOORRRR
  111.      Silicon Graphics Inc.; Apple Computer, Inc. for AIFF code.
  112.  
  113.  
  114. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  115.      intro(3a) for more about the  audio  library.  sfinfo(1), sfconvert(1),
  116.      soundfiler(1), sfkeywords(1).
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.